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I Introduction 

The purpose of this material is to help CP/M 2.X users 
interface to Konan's SMC-100 and SMC-200. It is assumed that the 
user is operational with CP/M 2.X on 8 inch CP/M compatible 
floppies. The components of this support package are as follows: 



I introduction 

II System Overview 

III Disk Diagnostics 

IV Mapping/Formatting 

V BIOS Driver 

VI Boot Facilities 

VII Fast Copy Program (MAPCOPY) 

VIII integration Guide 



The CMD drive was selected as an example. This is due to 
both it's popularity and it's unique requirement to follow volume 
changes with a seek. Code written for the CMD is easily 
converted to non-CMD but the opposite is not true. 



II System Overview 

KONAN's BIOS is shipped configured for a 96 or 32 megabyte 
CMD drive 1 . Due to CP/M 2.X , s limitation of 8 megabytes per 
logical unit the CMD has been divided into 2 logical units per 
surface. The removable platter is drives A & B,(A-tracks 0-401, 
B=402-803). CP/M will access the fixed surface as units C & D f 
C*tracks 0-401, D=402-803) for 32 megabyte drives and as C 
through L for 96 megabyte drives. 

The driver supplied will also handle an 8 inch floppy on a 
Tarbell controller. KONAN does not support the floppy drivers 
and makes no claims concerning their reliability or efficiency. 

KONAN 1 s hard disk driver has the following features: 

* 512 hyte sectors* Greatly increases storage 
over 128 byte formats. 

* Tntftgral drivers After boot the driver ROM is , 
phantomed (SMC-100), allowing the use of all 64K. 

* Ma p pin gs Allows efficient foolproof mapping of 
bad media locations. 



Programs currently supplied in KONAN's CP/M* 2.X Support Package 
include: 

1. MAPBI0S3 

A bios for the SML-100/200. Included are drivers for Tar- 
bell floppy controller. 

2. CP/MNDMA 

The boot ROM source. (Applicable only to the SMC-100). 

3. KONGEN ^ ^ M JJ , 

A program to generate a bootable system on the hard disk. 

(Parallels CP/M* Sysgen). 

4. DIAGNOSTICS 

IORAMS - Controller RAM test 
DMARAM - DMA test (SMC-100 only) 
LACEDIAG - Media test 

5. MAPC0PY3 

Fast copy, 16 megabytes in 3 minutes, for binary backup. 

(For SMC-100 only). 

6 . MAPPER3 

Fast format program. Allows user to view, alter and create 

bad track map. 

7. MEMMOVE 

Program used as part of the boot. 



NOTE: All programs provided in source code. 



Ill Diagnostics: 

The following diagnostics should be run prior to attempting 
to integrate CP/M* onto your disk. 

1. IORAMS 

2. DMARAM (if applicable) 

3. LACEDIAG 

The CP/M Support Package does not normally use DMA, Failure 
of the DMARAM test will not prevent using this support package. 
If the user has a SMC-100 and DMARAM runs, then DMA can be 
equated TRUE in LACEDIAG and MAPBI0S3. MAPCGPY3 requires DMA in 
order to function. T.ACEPTAG IS A DESTRUCTIVE TEST. After running 
LACEDIAG the unit will require reformatting. 

To test a system with data on it, first write protect your 
drive and then proceed as follows. 

1. Run IORAMS 

2. Run DMARAM (if applicable) 

3. Run MAPPER3 (selection "3" then "5") 

This will verify the S-100 and SMD interfaces, test the 
media, and verify all controller functions except writing. If 
disk has a removable media a "scratch" pack should be inserted 
and LACEDIAG run. 

IORAMS 

This test checks the sector buffer using 1.0. commands, 

(non-DMA). It verifies the following: 

1. Board selection address 

2. On board RAMs 

3. RAM counters 

DMARAM 

This test is similar to IORAMs except it uses DMA to 

transfer data from the SMC-100 to the host. 

After starting the test a brief description of the test is 
displayed. Press any key to get the first of two questions. The 
questions are: 

STARTING MEMORY PAGE: 00 

ENDING MEMORY PAGE: 00 

The lowest possible starting memory page is 05. This causes 
the memory beginning at hex address 0500 to be tested. The 
ending page must be selected to not overlap the BIOS. When first 
running the test a low value, typically 10, is often used. These 
entries would test memory from 0500 thru 1000 hex. 



LACEDIAG 

This test serves two purposes: 

1.' it test the disk subsystem independently of the BIOS 

or Boot ROM 
2. It aids in the location of Media flaws. 

IMPORTANT! THIS TEST DESTROYS THE DATA AND MEDIA HAP ON THE 
DRIVES (S) BEING TESTED. 

After runn in g the Diagnostic/Media teat the dr i ve must he refor- 
matted (and mapped if desired). 

Disk Diagnostic/Media Test Abstract 

Upon entering the Konan Media/Diagnostic test the following 
message is printed: 

KONAN MEDIA TEST REVISION N DD-DD-DD where N is the revision and 

D is the last date updated, 

DMA DISABLED BASE OP I. 0. PORTS IS 90 SECTOR SIZE - 512 

The operator is then prompted as follows: 

unit ? Enter a one (1) digit number corresponding to the unit to 
test. (Normally 0) 

drive type ? (OCMD M=MMD)? Enter C for CMD (ie. Phoenix) , M for 
all others. 

crctest ? (N«NO Y=YES) ? If yes, CRC is force to be bad. If 
following read fails to detect bad CRC an error is printed. 
Normally enter N. 

byte for by te COMPARE?? Verifies each byte of data in addition to 
the CRC and header tests. Greatly slows the test. Normally enter 
N. 

test read d ata at all offsets? Causes the strobe early/late and 
offset forward/backward to be used on each read pass. Aids in 
finding marginal data. Greatly slows the test. Normally enter N. 

first track ? Decimal address of the first track to be tested. 

t,ast TRACK ? Decimal address of the last track to be tested. 

first head ? Address of first head to test. With CMD, zero is for 
removable, 1 for first fixed, 2 for next, etc.. For MMD, zero - 
zero, 1 = 1, etc.. 

last head ? Address of last head to test. 



interlace pattern ? Interlace pattern. Allows speed of diagnostic 
to be matched to system/disk. 

last sector ? Last sector to test. Enter to test only one 
sector per track, 35 to test all 36 sectors. 

The operator may interrupt the test at any time by pressing a 
Control C, this will print the following messages 

BREAK TYPE D FOR DOS, R TO RESTART AND CR TO PRINT STATUS AND 
CONTINUE 

Typing D will cause a return to CP/M via a JMP 0. R will restart 
the test, and carriage return will print the status as follows: 

PULL PASSES-09 R,W PASSES-0037 ERRORS-000000 
SECTORS READ=0000E808 0002 00 

Where FULL PASSES equal the number of times the drive has written 
and read all selected sectors with the following patterns: All 
zeroes, All ones, Ripple up, Ripple down, floating zero and 
floating one. One each read/write pass the base for the ripple 
and floating patterns changes. 

R,W PASSES is a hex number equal to the number of read write 
passes through the selected portion of the disk. 

ERRORS is a total of all errors occurring since the test was 
started, in hex. 

SECTORS READ is the hex number of sectors read. 

The last line is the decimal address where the break occured. 
The first four digits are track, then sector and finally head. 



DATA ERRORS PRINT AS FOLLOWS* 



Decimal 


Track 




Head 




Sector 


0005 


1 33 


0005 


1 33 


0005 


1 02 


0005 


1 02 


PASS 


0002 


0002 


1 14 


0002 


1 18 


TRCK 


H SC 


0002 


1 18 


0002 


1 22 


0002 


1 22 


0002 


1 26 


0002 


1 26 


PASS 


0005 


0005 


1 00 


0005 


1 04 


0005 


1 04 


0005 


1 08 


TRCK 


H SC 


0005 


1 08 


0005 


1 12 


£££ 




BD=BAD 


GD-GOOD 



Track f Head, Sector 
in the form Good/Bad 

0005/PFPF 01/FF 21/FF L,BD 
0005/FFFF 01/FF 21/FF L,BD 
0005/FFFF 01/00 02/05 L,GD 
0005/0005 01/01 02/ID L,GD,R 
1 14 0002/FFFF 01/FF 0E/FF N,BD 
0002/FFFF 01/FF 0E/FF N,BD 
0002/FFFF 01/FF 12/FF N,BD 

TRACK HEAD SCTR TYPE WORD, GOOD/BAD 
0002/FFFF 01/FF 12/FF N,BD 
0002/FFFF 01/FF 16/FF N,BD 
0002/FFFF 01/FF 16/FF N,BD 
0002/FFFF 01/FF 1A/FF N,BD 
0002/0002 01/01 1A/0E N,GD, 



1 00 FFFA/FFFA FE/FE FF/FF 
FFFA/FFFA FE/FE FF/FF E f BD 
FFFA/FFFA FE/FE FB/FB E f BD 
FFFA/FFFA FE/FE FB/FB E,BD 
FFFA/FFFA FE/FE F7/F7 E f BD 

TRACK HEAD SCTR TYPE 
FFFA/FFFA FE/FE F7/F7 E,BD 
FFFA/FFFA FE/FE F3/F3 E,BD 



R <RETRY, if retry is 
always bad, error is 
usually a write error 

E,BD 



WORD, GOOD/BAD 
013, 00/08 <word 13 is bad 
013, 00/08 it should have 
been 00, was 08 
If bad data, printed in 
this area. If this is 
blank then data was OK. 



NON-DATA ERRORS 

Non-data errors are also displayed, 
status also prints. These errors are: 

SELECT ERROR: (could not select unit) 

TIMEOUT ERROR: (done loop timed out) 

WRITE FAULT ERROR 

SEEK ERROR 

HEAD SELECT ERROR 



After printing them the 



IV MAPPING/FORMATTING 

Prior to using CP/M on the SMC-100, the drive should be 
formatted.' The Format program formats one surface at a time. 
Please note that each surface is two logical units! The special 
mapping format program also performs a mapping function. This 
allows the user to reassign bad tracks to alternate tracks at the 
end of the disk. Once the reassignments have been made the 
substitutions are transparent to the customer. The mapping 
information is kept in the last sector of track zero on each 
surface. A system map is constructed each time the disk is warm 
or cold booted. When a track is reassigned the bad track is 
marked as "bad" by the Format/Mapping Program and the replacement 
map is formatted with the address of the bad track. If a bad 
track is found the driver will generate a new map and try again. 
This prevents errors if a pack is exchanged without performing a 
warm boot, ie control C. 

The following points should be noted : 

1. Track substitution (as opposed to sector 
substitution) reduces memory requirements 
and speeds operaton. 

2. Interchanging packs will not cause data to 
be misplaced. (CP/H is write protected, 
format causes driver to rebuild the system 
map and retry on read). 

3. Format time per surface will be under two 
minutes by use of a special interlace. 
This does not alter the format, ie, phy- 
sical track N is always formatted as N. 

MAPPER3 is shipped configured for a CDC Phoenix drive, (CMD EQU 
TRUE). For drives with a "normal" head select, change CMD EQUATE 
to FALSE and reassemble. 



After selecting unit and head MAPPER3 gives the operator the 
following choices: 

ENTER 1 TO CREATE NEW MAP, (NORMAL FORMAT) 

2 TO APPEND OLD MAP, (REFORMAT DISK) 

3 TO VIEW OLD MAP 

4 TO REPLACE BLOWN MAP, (CAUTION!) 

5 TO READ VERIFY DISK, (AFTER 1, 2, 3, OR 4 ONLY) 

6 TO RESTART 

7 TO ABORT 

selection 1 is the normal format. This is the only function in 
this program that is required. The others are for 
diagnostic purposes* 

selection 2 allows an additional bad track to be added to the 
map. The entire surface is then reformatted. 

selection 3 allows the current map to be displayed, 

SELECTION 4 replaces a map. It does not reformat the disk. It's 
only use is as a diagnostic and, in the unlikely 
event that the map sector is glitched, it can build a 
new map sector without formatting. 

selection 5 is used to read the entire disk, using mapping. This 
is a useful diagnostic, as it will display the 
location of any data errors. 

selection 6 allows the head and unit to be changed. 

SELECTION 7 returns to CP/M 



Surface Hap 

Each surface appears as follows: 



T0 Ti 

T 2 T 3 T 4 T 5 T 6 T 7 T 8 Tg 

T Ti 

T 2 T3 T4 T 5 T 6 T 7 Ts T9 



Track 



Track 1 



T ti 

T2 T3 T4 T5 T6 T7 Tg T9 
11100101 



Track N 
End of Map 



The table may be of any length, up to the limit of the sector. 
(The total number of tracks mapped in any system r however, must 
not exceed MAPSIZE/2-1, where MAPSIZE is the storage reserved in 
the driver). 

Good tracks are not listed. Each listed track is aaal? 11 ** a 
replacement track dependent upon its position in the table. The 
first track is assigned to 804, the next to 805 and so forth. If 
a spare is bad it may also be mapped, ie, track 213 could map to 
805 which maps to 807. An alternate way to handle a bad spare 
map is to map it to itself, ie, make the fourth entry in the 
table an 807. 
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System Hap 

The system map constructed by MAPBIOS contains the maps of each 
surface, 'The MAPBIOS routine which constructs the SYSMAP is 
called SNAPPER. It builds a map from all drives and surfaces 
that are read. Not ready units are skipped by and no error is 
generated. The map looks as follows: 



U0 Ul H0 Hi H2 T0 T X 

T 2 T 3 T 4 T 5 T 6 T 7 T 8 Tg 

U H Hi H 2 H 3 T T X 

T 2 T3 T 4 T 5 T 6 T 7 T 8 Tg 



Entry 1 
Entry 2 



U0 Ul H Hi H2 T Tl 
T2 T3 T4 T5 Tg T7 Tg T9 
1110 1 1 



Entry N 
End of Nap 



Where U is the unit # 
H is the head 
T is the track 



The following pages flow chart the MAPPER3 program. Note that 
the routines KCONMON and SMAPPER are the same ones used by 
NAPCOPY, NAPBI0S3, and MAPPER3. 
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MAPPING 



V 

Zero Buffer 




START 



Start messaqe 
ask "unit?" 




NO 



Print "Select 1 
Error 



3sTc 
select it 
store at HEAD 




NO 



9> 



Print "Select 
Error 



iNl'EK 1 to api 
pend/view old ^ 
map.2 to creaq e 



new 




READ sector 
"last" track Q 
into buffer 




Print "Disk" 
Error 



error? 



w NO 






"Track Map 
Kaput" 
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NAPPING cont'd 




Print Enter 
Track/CR to 
map additional 
tracks, CR 

Mm 



YES 





Push charactex 
on temporary 
stack 



-&. 



Print Reformal 
with new nap? 
CAUTION 
If answer yes 
two logical unills 
will be reformat 
ted destroying 
all data 




Convert to 
decimal 



Place in 
table 




NQ > GO 



^YES 
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NAPPING cont'd 




KiU all bad 
tracks 






Format track 
"0" write map 



I 



Format disk 



From 1 to 804 
tracks, seek 
using subsfritatEon 



3L 



Read all re- 
port any errors 



T 

GO 
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SUB TRACK - this routine uses the system map to map bad tracks to 
good tracks. 




EE = track 
desired 



±. 



Point to first 
-^| table entry 
H/L « table adc 



& 



2ES. 




Increment 
table add 



YES 



Set desired =■ 
to 804 + count 
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SOB TRACK cont'd 




Set sector 
DMA address 
Clear bus 



Calculate physical 
address, place in 
PTRK, P unit 
P head 




NO 



YES 



New - Old 



Select (Jkiit 




Unreport. 



Select Head 




Good 



YES 



NO 



£) report 



Sub Track 



OOCA 




SNAPPER The purpose of this program is to create the system track 
map. The map is built by adding each surface to the map. 



lftiit - 





Track ■ 


- 


Load - 





Sector 


- Max 




NO S Max 





Max 



TMC 
unit 



YES 



( RET \ 




Read Buf 




Sys map 
Kapoot 



JflESL 



-YES <<E7? 



if 
full 




NO 



Place in 
table 



JL 



Place next 
byte in table 
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V BIOS Disk Driver - The BIOS's supplied by KONAN have the follow 
ing features: 

1. Blocking and Deblocking 

The disk uses 516 byte sectors, with 4 
byte header and four 128 byte logical sec- 
' tors per physical sector. This increases 
the storage in a CDC CMD-32 from 24 mega- 
bytes with 128 byte sectors to 21*5. mega- 
bytes. Performance is also improved. 

2. No hardware interlace. 

Blocking and Deblocking make sectors 
available in groups of four. Typically, 
system overhead between sectors is 7 to 20 
milliseconds or 28 to 80 per physical sec- 
tor. The disk revolves every 17 
milliseconds. This speed makes interlace 
unnecessary. Format and Duplicate programs 
use a logical interlace making system backup 
and formatting extremely fast. 

3. Track Mapping 

Allows media flaws to be bypassed with 
minimal memory requirements, completely 
negligible system degradation and safegaurds 
against improper pack exchanges. 

4. Integral Driver 

Removes IK driver ROM after boot to allow 
full use of 64R. 

5. 32 or 96 Megabytes 

Supports 32 megabyte disk as units A, B, C 
and D or a 96 megabyte disk as units A 
through L. Drive M is a Siemens or Persci 
floppy drive with a Tarbell controller. 

6. Error Recovery 

The driver tries to read with all possible 
combinations of offsets and strobes. Each 
is tried twice, then the drive recalls, 
builds a new system map and tries again. In 
all, 39 retries preceed flagging a hard disk 
error. 
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7. Error Reporting 

The hard disk reports the following errors, 



A write time out error 

B write fault 

C read time out 1 

D checkword error 1 

E format error 

P hard read error 

G unit select error 

H head select error 

I hard seek error 

J seek time out 

K recal time out 

L S-mapper error 
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Driver 

The driver uses Digital Research's Blocking and Deblocking 
Algorithms. The driver has two entry points, writehst: and 
readhst:. Parameters are passed to it in the following memory 
locations: 



hstsec: 
hsttrk: 



hstdsk: 



defines the host sector 

host track #. Must be added to the 

units first track, ie add 402 to even 

unit numbers. 

for A, 1 for B, etc. 



The equate headg: is set to the number of heads per unit. 
It is set to 2 for 32 megabyte units, 4 for 64 and 6 for 96. 





HEADQ BQU 2 




Logical 
Uhit 


Physical 
Uhit 


Head 


Tracks 


T 








0-410 


B 








402-803 


C 





10 


0-401 


" D 





10 


402-803 


E 


1 





0-401 


f 


1 





402-803 


G 


1 


10 


0-401 


ti 


1 


10 


402-803 


i 


2 





0-401 


j 


2 





402-803 


K 


2 


10 


0-401 


L 


2 


10 


402-803 





HEADQ BQU 4 




Logical 
tJnit 


Physical 


Head 


Tracks 


A 








0-401 


B 








402-803 


C 





IQ 


0-401 


D 





*o 


402=803 


E 





11 


, 0-401 


F 






402-803 


G 





12 




H 





12 


.402-80.1, 


T 


1 





0-4Q1 


J 







An:>-fifn 


K 


l 


in 


n-dm 




1 


10 





♦Must be 32 megabyte drive 





HEADQ EQU 


6 




logical 
liiit 


Physical 


Head 


Tracks 


A 








jiiMJft 


B 


u 


U 


4U2-BU.J 


r 


n 


l n 




D 





10 


402-803 


■ - 
E 





11 


0-401 


F 





11 


402-803 


G 





n 


0-401 


H 





12 


402-803 


I 





13 


0-401 


J 





13 


402-803 


K 





14 




L 





14 
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DRIVER cont'd 




sets sector, 
caimon) DMA, track, 
head, unit 



clear bus 
and status 



; build header, 
DMA write 



Zero buffer 
Disk Write 



2t 




timeout: ^DONE?"^^ 



Print timeout 
error, write 



YES 



<^> 



Print write 
ERROR 



NONE 



£> set status ^ 
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DRIVER cont'd 



[READHST J 




oo rav 





CALL \ 

k 00*10^ 

v y 



' clear bus, 
| zero buffer 
1 fttmr (xnmtpflL 



Do disk read 




Jffifl 



YES 



Test: error court 
set print stati|s 
as necessary 




set error bits 
on bus, at 19 cill 
recal, kill unity * 
call Mapper 
mil K fYTtra 



YES 




NO 



,erro: 
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Read Recovery 

RCOVRE: 

The read recovery program sets the recovery bits on the bug. 
After trying all offsets and strobes multiple times it will 
recall, reselect unit r head, track and sector, and then retry all 
legal combinations of offsets and strobes again. This is 
accomplished by incrementing an error counter, CERRC, whose ibits 
get mapped onto the disks bus. Definition of the bits in CERRC 
are as follows: 



7 6 5 



phase 2 

offset minus 



3 2 



L 



CERRC 



strobe early 
strobe late 
dummy 
offset plus 



CERRC is incremented between each read attempt, and then the bus 
is updated to perform the desired recovery operation. 111*9*1 
combinations, (strobe early and strobe late or off set plus and 
offset minus) are skipped. Bit two is ignored, causing all 
strobes to be tried twice at each offset. When the hex count 20 
is reached the drive is recalibrated, reselected, a new system 
map is built and the entire sequence is repeated. 
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VI BOOT 

Cold Boot (This Subsection applies only to the SMC-100) . 

The Cold Boot program resides in ROM. It occupies IK of memory 
space. The ROM may be phantomed after the boot. KONAN's SMC-100 
can generate and/or respond to phantom via jumpers. 

To help accomodate the many different memory/system con- 
figurations KONAN provides the user many boot options. (See 
attached configuration sheet). These options include: 

1. Phantom: Allows boot ROM to disappear after 
boot and memory to replace it. 

2. ROM address: ROM may be placed on any IK 
boundary from 8000H to PC00H (Note - the SMC- 
100 may be jumpered to any of these addresses 
but the ROM is "blown" for one specific address 
and is not relocatable). Unless otherwise 
needed, ROM's are blown for F000. 

3. Boot Memory Address and Jump Address: May be 
set to the base of BIOS. 

Note that the SMC-100 will not provide a power on Jump. This 
must be performed by the user, normally on his CPU. 

Note that the Boot process is multi-staged. First, the PROM 
copies the necessary portion of itself into system RAM. Next, if 
this option is needed, the ROM phantoms away. Then the code in 
RAM is executed, reading the entire system image into RAM, 
beginning at location 0000H Track 0, Sector contains a short 
program (MEMMOVE) to relocate the system image to the appropriate 
RAM location. This program is executed upon jumping to 0000H. 
Finally, a jump is executed to the BIOS, and the system is up and 
running. 
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TYPICAL COLD BOOT CONFIGURATIONS 



jebol 



Phantomed 
Memory 



0000 



8000 



FD0S 
BIOS 



PROM is at location 8000H. 
Phantom is enabled. Memory 
from 8000H to 83FFH must 
phantom. Memory from 10 0H to 
the base of the BIOS may 
phantom. After boot all 
memory is available. 



FDOS 



BIOS 



£BQfcL 



0000 



FC00 



PROM resides above BIOS. 
Phantom maybe enabled or 
disabled. 



F000 






0000 



BIOS 



PROM is at F000. It must be 
phantomed and so must the top 
IK of memory. This configura- 
tion can only be used if the 
memory can phantom the top 
IK. Not the BIOS and PROM 
overlap. This is possible 
because the last IK of BIOS 
is uninitialized buffer areas. 



25 



Warmboot 

Warmboot performs the following functions: 



Read in "PDOS" 



± 



Construct 
System Map* 



Initialize 
location 0-7 




* If Mapping is implemented 
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Alternate Boot procedures: 

The SMC-200 has no ROM. The nature of the SMC-100's Phantom line 
occasionally makes booting off the ROM very difficult. The 
following options may be helpful. 



A. 1) Boot off floppy. 

2) Move hard disk bios into the TBA using DDT. 

3) Move BIOS into place with DDT's memmove. 
(This is also an excellent diagnostic step 
when integrating an SMC-100 boot. 

B. 1) Boot off floppy 

2) Execute a COM program that performs steps 2 & 
3 above wthout use of DDT. 

C. 1) Write a boot ROM to reside on CPD board or 

elsewhere. It can imitate the COLD boot 
provided or just read in sector zero which 
would hold a boot program. 
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VII Fast Copy 

The Fast Copy program copies any hard disk surface to any other. 
It is a high speed copy using an interlace of 3 or 4, depending 
upon host system speed. A system map is built to map the bad 
tracks to alternates to maintain compatibility with the operating 
system. The primary function of this program is to shorten the 
length of time required to perform a backup. The duplicate 
program differs from PIP** in the following ways: 

1. Speed: MAPCOPY is many times faster that PIP. 

2. Order: MAPCOPY does not reorganize files in 

any way. PIP** makes all files con- 
tiguous. PIP should be used 
occasionally to reorganize files. 

MAPCOPY uses DMA and will, therefore, only run on an SMC-100 that 
can run DM ARAM. 
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VIII INTERGRATIOK GUIDE 



The task of integrating your particular hardware con- 
fiauration into the CP/M* operating system can be quite 
lonf using. This guide is meant to be used in ""junction with 
the alteration manual supplied with your «/«•*■£■. " is not 
intended for use by the individual who is totally unfamiliar witn 
cp/m integrations. For those who have never attempted this 
"f ore, P !las refer to the manuals supplied with your operating 
system. The diagnostics in Section III should be run 
PPTOW TO INTEGRATION! 

The assumption made at this point is that you are al«ady 
■up and runninl'on a CP/M system, based I on either :■*"£■*« 8 ' 
single density, single-sided, IBM/CPM compatible floppies 

The first step is to assemble, load, and run the MAPPER3 
program. ' Thi. wil'l format any surface of *•>"« "/wctiSS 
menu selection, 1 for each surface of the hard disk. Jf ee « ec " on 
IV for further details on the MAPPER3 Program). The hard disk 
drivers are integral to the program, which calls CP/M only for 
the terminal I/O. This program takes about 90 seconds to run, 
and responds with the sameVompt. To exit the program and 
warmboot, simply enter Control C. 

The next step is to assemble and load the KONGEN program. 
This program is KoWs analogue to , the ; sysge » 'Program provided 
by Digital Research. The purpose of this program is *° Pj ace * n 
image of the operating system on the boot * «ck of the har a dxsk 
from memory or to place an image of the boot track ™*° ■•■ OE *£ 
Tf vou are simply making a copy of an already £U «J5, 10 . n 7i 
operating system (which i. good practice, in case you "blow- it 
during a modification of your operating environment), you need 
only retrieve the image from the hard disk surface whioh contain. 
4<- swao Dlatters» and place the image on the new platter, ine 
KONGEN Program w 8 i'll leave any existing files and the di Rectory 
intact. This program also contains i^egral drivers for the hard 
disk and can, of course, be run under your floppy disk CP/M. 

To procede with the integration process, you must somehow 
create the desired system image in memory, so, that you may ^ place 
it on the hard disk (using KONGEN). There are three blocks 
which must be loaded into the appropriate memory locations. 
These bloc ks include the CP/M FDOS, (the CCP and BIOS), .the 
-boot" routine, and the BIOS. Each of these blocks will be 
discussed next. 
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The first block, the FDOS, is created using the MOVCPM 
program supplied with your operating system. This program 
creates a- version of the FDOS relocated to be used with your 
desired memory size. Due to the size of the disk allocation 
tables, which reside at the end of the BIOS, you should^ use 
MOVCPM to create an FDOS image for a system 3K smaller than your 
actual memory requirements. In the following, it will be assumed 
that the COM file created with MOVCPM will have been called 
CPM.COM. 

The creation of the second block is generally the most 
formidable of the steps that must be taken in the intergration 
process. This is the BIOS. KONAN provides a BIOS assembly file 
which is to be used as a guide for the installation of your 
particular hardware requirements. The two simplest steps in the 
modification of this BIOS, are setting the memory size desired, 
and altering the terminal I/O drivers. 

To set the memory size, set the 'MSIZE* equate at the 
beginning of the BIOS file to the desired value. If you want to 
generate a 4 8K system, set MSIZE to 48. (Recall that the CPM.COM 
file will have been generated for 3K less than this value). 
After setting this value, find the terminal routines included by 
KONAN and alter or replace them to meet your need. For the sake 
of sanity, it is generally a good idea to alter only these two 
things the first time you attempt your integration, and only 
after succeeding to generate a bootable hard disk, attempt to 
install any other changes (such as floppy disk routines), that 
you will need. 

For your convenience, KONAN has included sample Tarbell 
floppy drives and the logic in the disk select routine to route 
through either the hard disk drivers or the Tarbell drives, 
depending on the logical drive number. These routines are meant 
only as a sample. Although we have been using them in-house for 
quite some time, they are not meant to be assumed bug-free or 
compatible with your equipment. For your information, the SMC- 
100 version of the BIOS is designed to be used with a 96 megabyte 
Control Data Phoenix unit (although it need not be altered to run 
with the 32 megabyte units), as logical devices 'A 1 though 'L' 
(•A'-'d* f 0r 32 megabyte units) and the floppies as logical units 
•M' and 'N 1 . 

When you have completed making the desired changes to the 
BIOS, assemble it. It is not necessary to load this file. After 
assembling, type the PRN-file created by the assembler, and take 
note of the 'CCP' and 'BIOS' equate values. as you will need 
them later. In particular, the CCP equate value is the value to 
which you must set the 'DESTIN 1 equate in the MEMMOVE file. The 
BIOS equate will be used to calculate the read-offset in the 
following paragraphs. 
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The third block, the "BOOT" routine, is a short file called 
MEMMOVfc. 1 • The boot process for the hard disk using the KONAN 
controller is actually done by the ROM on the controller. This 
ROM brings the entire system into memory, beginning with memory 
address &000H. A jump is then performed to location 0000, which 
will contain the MEMMOVE routine. This routine has only a single 
equate which must be modified for each different memory size 
integrated. This equate is called •DESTIN 1 in the MEMMOVE.ASM 
file. It should be set to the address for the CCP (PDOS). You 
may determine this value by inspecting the BIOS print file 
created in the following paragraphs. Once determined, this value 
should be set and the MEMMOVE program assembled. It is not 
necessary to load this file. 

At this point, you should have created the three blocks 
needed to combine into the total system image which must 
ultimately reside on the hard disk boot track. Use DDT (see your 
CP/M manuals) to bring these files into memory. The following 
are the steps you should take under DDT* 



YOU TYfe 



DDT CPM.COM 
IBIOS.HEX 



R (OFFSET) 



This is the file created 
by MOVCPM or whatever you 
named your modified BI0S> 

This offset value is 
easily calculated by sub- 
tracting the 'BIOS 1 equate 
from 11F80 HEX 



I MEMMOVE. HEX 



This always resides at 
780H, regardless of your 
memory size. 



R780 

GO 

KONGEN 



Warmboot 

and run KONGEN 
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Since you have just formed the System image in . memory*, when 
KONkSfeiq ^asks %ou :Zoz the image souce, simply . hit return. When it 
asks you for tfce destinatlbn, answer 'A 1 . These responses will 
place the image in RAM ontb- the outer boot track ; of thejtop 
platter. For the SMC-100 version with the Control Data :drive r 
this is the removable cartridge. 

We hope : that this guide will clear up jthe traditionally 
muddy waters of system integration and modification. Using the 
various tools that we have provided, the generation process 
should proceed in a fairly straight forward manner; Good fcuckiU 
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